Save(String,EncoderBase,EventHandler<ProgressEventArgs>) Метод (VintasoftImage)

В этом разделе

Сохраняет этот объект VintasoftImage по указанному пути, используя указанный кодировщик.

Синтаксис

Visual Basic
C#
Управляемые расширения для C++
C++/CLI

'Declaration

Public Overloads Sub Save( _
   ByVal filenameИмя файла, в котором должно быть сохранено изображение.
 As System.String, _
   ByVal encoderКодировщик для сохранения изображения.
 As Vintasoft.Imaging.Codecs.Encoders.EncoderBase, _
   ByVal savingProgressДелегат процесса сохранения изображения. Может быть установлен в null (Nothing в Visual Basic).
 As System.EventHandler(Of ProgressEventArgs) _
)

public void Save(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase encoder, 
   System.EventHandler<ProgressEventArgs> savingProgress
)

public: void Save(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase* encoder, 
   System.EventHandler<ProgressEventArgs*>* savingProgress
)

public:
void Save(
   System.String filename, 
   Vintasoft.Imaging.Codecs.Encoders.EncoderBase^ encoder, 
   System.EventHandler<ProgressEventArgs^>^ savingProgress
)

Parameters

filename: Имя файла, в котором должно быть сохранено изображение.
encoder: Кодировщик для сохранения изображения.
savingProgress: Делегат процесса сохранения изображения. Может быть установлен в null (Nothing в Visual Basic).

Исключения

Исключение	Описание
System.ArgumentNullException	Выбрасывается, если filename или encoder равен null.
EncoderException	Выбрасывается, если при сохранении изображения произошла ошибка.

Ремарки

Поддерживаемые форматы изображений: BMP, GIF, JBIG2, JPEG, PCX, PDF, PNG, TIFF.

Подходящий кодировщик выбирается автоматически из расширения имени файла, исключение возникает, если кодировщик не найден для расширения файла, указанного в filename.

Если изображение сохраняется в новый файл (filename != SourceInfo.Filename), этот метод:

сохраняет изображение в новый файл BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF, если MultipageEncoderBase.CreateNewFile = true; Файл, указанный как filename, заменяется, если он существует.
сохраняет изображение в новый файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false и файл, указанный как filename, не существует.
добавляет изображение в новый файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false и файл, указанный как filename, существует.

Если изображение сохраняется в исходный файл (filename == SourceInfo.Filename), этот метод:

сохраняет изображение в исходный файл BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF, если изображение изменено (IsChanged = true) и исходный файл содержит только одно изображение
выдает исключение, если изображение сохранено в исходный файл BMP/GIF/JBIG2/JPEG/PCX/PDF/PNG/TIFF и изображение не изменено (IsChanged = false)
добавляет изображение в исходный файл JBIG2/PDF/TIFF, если MultipageEncoderBase.CreateNewFile = false, файл указан filename существует

Пример

Вот C#/VB.NET код, который демонстрирует, как загрузить изображение с аннотациями XMP с диска и сохранить изображение как TIFF файл с аннотациями WANG.

VB.NET


' load image from file
Using image As New Vintasoft.Imaging.VintasoftImage("c:\imageWithXmpAnnotations.tif")
    ' create TIFF encoder
    Dim encoder As New Vintasoft.Imaging.Codecs.Encoders.TiffEncoder(False)
    ' save annotations in WANG format
    encoder.AnnotationsFormat = Vintasoft.Imaging.AnnotationsFormat.Wang
    ' save image to file
    image.Save("c:\imageWithWangAnnotations.tif", encoder)
End Using


// load image from file
using (Vintasoft.Imaging.VintasoftImage image =
    new Vintasoft.Imaging.VintasoftImage(@"c:\imageWithXmpAnnotations.tif"))
{
    // create TIFF encoder
    Vintasoft.Imaging.Codecs.Encoders.TiffEncoder encoder =
        new Vintasoft.Imaging.Codecs.Encoders.TiffEncoder(false);
    // save annotations in WANG format
    encoder.AnnotationsFormat = Vintasoft.Imaging.AnnotationsFormat.Wang;
    // save image to file
    image.Save(@"c:\imageWithWangAnnotations.tif", encoder);
}

Вот C#/VB.NET код, который демонстрирует, как загрузить изображение с диска и сохранить его как JPEG файл с качеством 10%.

VB.NET


' load image from file
Using image As New Vintasoft.Imaging.VintasoftImage("c:\original-image.tif")
    ' copy image to clipboard
    System.Windows.Forms.Clipboard.SetImage(Vintasoft.Imaging.VintasoftImageGdiExtensions.GetAsBitmap(image))

    ' process image in external image editor and place it back to the clipboard
    ' ...

    ' get image from the clipboard
    image.SetImage(Vintasoft.Imaging.VintasoftImageGdiExtensions.Create(System.Windows.Forms.Clipboard.GetImage(), True))

    ' save image to the file
    image.Save("c:\processed-image.jpg")
End Using


// load image from file
using (Vintasoft.Imaging.VintasoftImage image =
    new Vintasoft.Imaging.VintasoftImage(@"c:\original-image.tif"))
{
    // copy image to clipboard
    System.Windows.Forms.Clipboard.SetImage(Vintasoft.Imaging.VintasoftImageGdiExtensions.GetAsBitmap(image));

    // process image in external image editor and place it back to the clipboard
    // ...

    // get image from the clipboard
    image.SetImage(Vintasoft.Imaging.VintasoftImageGdiExtensions.Create(
        System.Windows.Forms.Clipboard.GetImage(), true));

    // save image to the file
    image.Save(@"c:\processed-image.jpg");
}

Требования

Целевые платформы: .NET 8; .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Смотрите также

Справочник

VintasoftImage Class
Члены типа VintasoftImage

AnnotationsFormat
Save(String)
Список перегрузок

Отправить отзыв